TimeMap - StrategyQuant plugin
==============================

TimeMap shows WHEN each strategy in a portfolio traded - a colored time map of
every trade (green = winner, red = loser), with the portfolio equity and an
optional SPY benchmark overlaid. Use it to see which strategies overlap in time
(correlated risk) and which complement each other (real diversification).

  * NO Python required.
  * NO backend, no local server.
  * NO configuration - it just works.

The whole plugin is a single HTML file that runs inside StrategyQuant.


Setup (about a minute)
----------------------
1. Unzip this file.
2. Copy the "TimeMap" folder into your StrategyQuant install:
      C:\StrategyQuantX###\user\extend\ResultsPlugins\TimeMap\
   (### = your version number, e.g. 144)
3. Restart StrategyQuant.
4. Done - a new "TimeMap" tab appears in the Results section.


How to use
----------
1. Run a backtest of a portfolio / composer (several strategies).
2. Select that result and open the TimeMap tab.
3. Each row is a strategy (sorted by time in market). Green blocks are winning
   trades, red blocks are losing trades. The blue line is the portfolio equity
   (right axis).
4. Use the chips at the top to toggle strategies on/off, and the Window buttons
   (All / 10y / 5y / 2y / 1y) to zoom the time range.

What to look for:
  - Strategies trading (and losing) at the SAME time  = correlated risk.
  - Strategies active at DIFFERENT times, or one green while another is red
      = diversification. That is what you want.
  - Red flag: every strategy red in the same column = systemic risk.


SPY benchmark (optional)
------------------------
The orange SPY line is fetched live from the internet (Yahoo Finance), so it
needs a working connection. If it cannot load, the rest of the plugin still
works - only the SPY overlay is skipped. StrategyQuant does not expose price
data to plugins, so a benchmark can only come from the web.


Files
-----
<SQ install>\user\extend\ResultsPlugins\TimeMap\
   |- index.html      the plugin (loaded by StrategyQuant)
   \- README.txt      short reference

No configuration. Nothing to launch. Just restart SQ and open the TimeMap tab.
